.. _cemIxLineToStart:

cemIxLineToStart
================
----------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cemIxLineToStart(
    VT_I4 MapIndex,
    VT_PR8 PosList
  )



DESCRIPTION
-----------


- 절대 좌표 직선 보간 이송을 수행합니다.
  
- 모션을 시작시킨 후에 바로 반환됩니다.



PARAMETER
---------


- MapIndex : 맵 번호(Map index). 이 맵 번호를 사용하기 전에 먼저 cemIxMapAxes 함수를 통하여. 해당 맵 번호에 유효한 축들이 맵핑 되어 있어야 합니다. 

- PosList : 이송할 목표 절대 좌표 값(각 축의 절대 좌표 값)의 배열 주소. 이 목표 좌표 배열의. 크기는 cemIxMapAxes 함수를 통하여 맵핑된 축의 수와 일치하여야 합니다. 거리의 단위는 “Unit Distance”에 의해 정의되는 논리적 거리를 적용합니다. 




RETURN VALUE
------------


+----------------+--------------------------------------------------------+
| Value          | Meaning                                                |
+================+========================================================+
| 음수           | 수행 실패. 자세한 내용은 ‘에러처리’ 편을 참고합니다. |
+----------------+--------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공.                                             |
+----------------+--------------------------------------------------------+


.. note::
  논리적 단위 거리는 cemCfgUnitDist_Set 함수에 의해 결정됩니다.

  

  □ cemIxLineToStart 함수를 사용하는 경우에는 cemIxIsDone 함수나 cemIxWaitDone 함수를

  사용하여 모션의 완료를 확인할 수 있습니다.